home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_qt.idb / usr / freeware / catman / p_man / cat3 / qbytearray.Z / qbytearray
Encoding:
Text File  |  1998-10-28  |  27.2 KB  |  463 lines

  1.  
  2.  
  3.  
  4.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       QByteArray - Array of    bytes
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       #include <qstring.h>
  13.  
  14.       Inherits QArray.
  15.  
  16.       Inherited by QBitArray and QString.
  17.  
  18.     PPPPuuuubbbblllliiiicccc MMMMeeeemmmmbbbbeeeerrrrssss
  19.       QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy (((())))
  20.       QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy (((( iiiinnnntttt ssssiiiizzzzeeee    ))))
  21.       QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy (((( ccccoooonnnnsssstttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy    &&&& aaaa ))))
  22.       ~~~~QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy ()
  23.       QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy&&&& ooooppppeeeerrrraaaattttoooorrrr====    (((( ccccoooonnnnsssstttt    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy &&&& aaaa ))))
  24.       cccchhhhaaaarrrr****    ddddaaaattttaaaa (((())))    ccccoooonnnnsssstttt
  25.       uuuuiiiinnnntttt nnnnrrrreeeeffffssss (((())))    ccccoooonnnnsssstttt
  26.       uuuuiiiinnnntttt ssssiiiizzzzeeee (((()))) ccccoooonnnnsssstttt
  27.       bbbboooooooollll iiiissssEEEEmmmmppppttttyyyy (((()))) ccccoooonnnnsssstttt
  28.       bbbboooooooollll iiiissssNNNNuuuullllllll (((()))) ccccoooonnnnsssstttt
  29.       bbbboooooooollll rrrreeeessssiiiizzzzeeee ((((    uuuuiiiinnnntttt ssssiiiizzzzeeee ))))
  30.       bbbboooooooollll ttttrrrruuuunnnnccccaaaatttteeee    (((( uuuuiiiinnnntttt ppppoooossss ))))
  31.       bbbboooooooollll ffffiiiillllllll (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr &&&& _d,,,, iiiinnnntttt _s_i_z_e====----1111 ))))
  32.       vvvviiiirrrrttttuuuuaaaallll vvvvooooiiiidddd ddddeeeettttaaaacccchhhh (((())))
  33.       QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy ccccooooppppyyyy (((()))) ccccoooonnnnsssstttt
  34.       QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy&&&& aaaassssssssiiiiggggnnnn (((( ccccoooonnnnsssstttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy    &&&& aaaa ))))
  35.       QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy&&&& aaaassssssssiiiiggggnnnn (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** _a,,,, uuuuiiiinnnntttt nnnn ))))
  36.       QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy&&&& dddduuuupppplllliiiiccccaaaatttteeee    (((( ccccoooonnnnsssstttt    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy &&&& aaaa ))))
  37.       QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy&&&& dddduuuupppplllliiiiccccaaaatttteeee    (((( ccccoooonnnnsssstttt    cccchhhhaaaarrrr **** _a,,,, uuuuiiiinnnntttt nnnn ))))
  38.       QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy&&&& sssseeeettttRRRRaaaawwwwDDDDaaaattttaaaa (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr ****    _a,,,, uuuuiiiinnnntttt    nnnn ))))
  39.       vvvvooooiiiidddd rrrreeeesssseeeettttRRRRaaaawwwwDDDDaaaattttaaaa (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** _a,,,, uuuuiiiinnnntttt nnnn ))))
  40.       iiiinnnntttt ffffiiiinnnndddd (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr    &&&& _d,,,, uuuuiiiinnnntttt _i====0000 ))))    ccccoooonnnnsssstttt
  41.       iiiinnnntttt ccccoooonnnnttttaaaaiiiinnnnssss (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr &&&& dddd    )))) ccccoooonnnnsssstttt
  42.       cccchhhhaaaarrrr&&&&    ooooppppeeeerrrraaaattttoooorrrr[[[[]]]] (((( iiiinnnntttt iiii )))) ccccoooonnnnsssstttt
  43.       cccchhhhaaaarrrr&&&&    aaaatttt (((( uuuuiiiinnnntttt iiii )))) ccccoooonnnnsssstttt
  44.       ooooppppeeeerrrraaaattttoooorrrr ccccoooonnnnsssstttt cccchhhhaaaarrrr**** ()const
  45.       bbbboooooooollll ooooppppeeeerrrraaaattttoooorrrr======== (((( ccccoooonnnnsssstttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy &&&& aaaa )))) ccccoooonnnnsssstttt
  46.       bbbboooooooollll ooooppppeeeerrrraaaattttoooorrrr!!!!==== (((( ccccoooonnnnsssstttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy &&&& aaaa )))) ccccoooonnnnsssstttt
  47.  
  48.     PPPPrrrrooootttteeeecccctttteeeedddd MMMMeeeemmmmbbbbeeeerrrrssss
  49.       QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy (((( iiiinnnntttt,,,, iiiinnnntttt    ))))
  50.  
  51.      RRRREEEELLLLAAAATTTTEEEEDDDD FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  52.       (Note    that these are not member functions.)
  53.       QQQQ____UUUUIIIINNNNTTTT11116666 qqqqCCCChhhheeeecccckkkkssssuuuummmm ((((ccccoooonnnnsssstttt cccchhhhaaaarrrr **** _d_a_t_a,,,, uuuuiiiinnnntttt _l_e_n))))
  54.       UUUUIIIINNNNTTTT11116666 qqqqcccchhhheeeecccckkkkssssuuuummmm ((((ccccoooonnnnsssstttt cccchhhhaaaarrrr **** _d_a_t_a,,,, uuuuiiiinnnntttt _l_e_n))))
  55.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&&    ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm    &&&& _s,,,, ccccoooonnnnsssstttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy
  56.           &&&&    _a))))
  57.       QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&&    ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm    &&&& _s,,,, QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy    &&&& _a))))
  58.  
  59.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  60.  
  61.  
  62.  
  63.      PPPPaaaaggggeeee 1111                         ((((pppprrrriiiinnnntttteeeedddd 9999////22222222////99998888))))
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))
  71.  
  72.  
  73.  
  74.       The QByteArray class provides    an array of bytes.
  75.  
  76.       QByteArray is    defined    as QArray<char>.
  77.  
  78.      MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  79.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy (((())))
  80.       Constructs a null array.
  81.  
  82.       See also: isNull().
  83.  
  84.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy (((( ccccoooonnnnsssstttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy &&&& aaaa ))))
  85.       Constructs a shallow copy of _a.
  86.  
  87.       See also: assign().
  88.  
  89.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy (((( iiiinnnntttt ssssiiiizzzzeeee ))))
  90.       Constructs an    array with room    for _s_i_z_e elements. Makes a
  91.       null array if    _s_i_z_e ==    0.
  92.  
  93.       Note that the    elements are not initialized.
  94.  
  95.       See also: resize() and isNull().
  96.  
  97.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy (((( iiiinnnntttt,,,, iiiinnnntttt )))) [[[[pppprrrrooootttteeeecccctttteeeedddd]]]]
  98.       Constructs an    array _w_i_t_h_o_u_t _a_l_l_o_c_a_t_i_n_g array space. The
  99.       arguments should be (0, 0). Use at own risk.
  100.  
  101.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::~~~~QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy (((())))
  102.       Dereferences the array data and deletes it if    this was the
  103.       last reference.
  104.  
  105.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::ooooppppeeeerrrraaaattttoooorrrr ccccoooonnnnsssstttt    cccchhhhaaaarrrr **** (((()))) ccccoooonnnnsssstttt
  106.       Cast operator. Returns a pointer to the array.
  107.  
  108.       See also: data().
  109.  
  110.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy    &&&& QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::aaaassssssssiiiiggggnnnn (((( ccccoooonnnnsssstttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy    &&&& aaaa ))))
  111.       Shallow copy.    Dereferences the current array and references
  112.       the data contained in    _a instead. Returns a reference to this
  113.       array.
  114.  
  115.       See also: operator=().
  116.  
  117.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy    &&&& QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::aaaassssssssiiiiggggnnnn (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ddddaaaattttaaaa,,,, uuuuiiiinnnntttt ssssiiiizzzzeeee ))))
  118.       Shallow copy.    Dereferences the current array and references
  119.       the array data _d_a_t_a, which contains _s_i_z_e elements. Returns a
  120.       reference to this array.
  121.  
  122.       Do not delete    _d_a_t_a later, QArray takes care of that.
  123.  
  124.      cccchhhhaaaarrrr &&&& QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::aaaatttt (((( uuuuiiiinnnntttt iiiinnnnddddeeeexxxx    )))) ccccoooonnnnsssstttt
  125.       Returns a reference to the element at    position _i_n_d_e_x in the
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 9/22/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))
  137.  
  138.  
  139.  
  140.       array.
  141.  
  142.       This can be used to both read    and set    an element.
  143.  
  144.       See also: operator[]().
  145.  
  146.      iiiinnnntttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::ccccoooonnnnttttaaaaiiiinnnnssss ((((    ccccoooonnnnsssstttt cccchhhhaaaarrrr &&&& vvvv )))) ccccoooonnnnsssstttt
  147.       Returns the number of    times _v    occurs in the array.
  148.  
  149.       See also: find().
  150.  
  151.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::ccccooooppppyyyy (((()))) ccccoooonnnnsssstttt
  152.       Returns a deep copy of this array.
  153.  
  154.       See also: detach() and duplicate().
  155.  
  156.      cccchhhhaaaarrrr **** QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::ddddaaaattttaaaa (((())))    ccccoooonnnnsssstttt
  157.       Returns a pointer to the actual array    data.
  158.  
  159.       The array is a null array if data() == 0 (null pointer).
  160.  
  161.       See also: isNull().
  162.  
  163.      vvvvooooiiiidddd QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::ddddeeeettttaaaacccchhhh (((())))    [[[[vvvviiiirrrrttttuuuuaaaallll]]]]
  164.       Detaches this    array from shared array    data, i.e. makes a
  165.       private, deep    copy of    the data.
  166.  
  167.       Copying will only be performed if the    reference count    is
  168.       greater than one.
  169.  
  170.       See also: copy().
  171.  
  172.       Reimplemented    from QGArray.
  173.  
  174.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy    &&&& QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::dddduuuupppplllliiiiccccaaaatttteeee    (((( ccccoooonnnnsssstttt    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy &&&& aaaa ))))
  175.       Deep copy. Dereferences the current array and    obtains    a copy
  176.       of the data contained    in _a instead. Returns a    reference to
  177.       this array.
  178.  
  179.       See also: copy().
  180.  
  181.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy    &&&& QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::dddduuuupppplllliiiiccccaaaatttteeee    (((( ccccoooonnnnsssstttt    cccchhhhaaaarrrr **** ddddaaaattttaaaa,,,, uuuuiiiinnnntttt ssssiiiizzzzeeee
  182.       ))))
  183.       Deep copy. Dereferences the current array and    obtains    a copy
  184.       of the array data _d_a_t_a instead. Returns a reference to this
  185.       array.
  186.  
  187.       See also: copy().
  188.  
  189.      bbbboooooooollll QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::ffffiiiillllllll (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr    &&&& vvvv,,,, iiiinnnntttt ssssiiiizzzzeeee====----1111====----1111 ))))
  190.       Fills    the array with the value _v. If _s_i_z_e is specified as
  191.       different from -1, then the array will be resized before
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 9/22/98)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))
  203.  
  204.  
  205.  
  206.       filled.
  207.  
  208.       Returns TRUE if successful, or FALSE if the memory cannot be
  209.       allocated (only when _s_i_z_e != -1).
  210.  
  211.       See also: resize().
  212.  
  213.      iiiinnnntttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::ffffiiiinnnndddd (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr &&&& vvvv,,,, uuuuiiiinnnntttt iiiinnnnddddeeeexxxx====0000 )))) ccccoooonnnnsssstttt
  214.       Finds    the first occurrence of    _v, starting at position    _i_n_d_e_x.
  215.  
  216.       Returns the position of _v, or    -1 if _v    could not be found.
  217.  
  218.       See also: contains().
  219.  
  220.      bbbboooooooollll QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::iiiissssEEEEmmmmppppttttyyyy (((()))) ccccoooonnnnsssstttt
  221.       Returns TRUE if the array is empty, i.e. size() == 0,
  222.       otherwise FALSE.
  223.  
  224.       isEmpty() is equivalent with isNull()    for QArray. Note that
  225.       this is not the case for QString::isEmpty().
  226.  
  227.      bbbboooooooollll QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::iiiissssNNNNuuuullllllll (((())))    ccccoooonnnnsssstttt
  228.       Returns TRUE if the array is null, otherwise FALSE.
  229.  
  230.       A null array has size() == 0 and data() == 0.
  231.  
  232.      uuuuiiiinnnntttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::nnnnrrrreeeeffffssss (((()))) ccccoooonnnnsssstttt
  233.       Returns the reference    count for the shared array data. This
  234.       reference count is always greater than zero.
  235.  
  236.      bbbboooooooollll QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::ooooppppeeeerrrraaaattttoooorrrr!!!!==== (((( ccccoooonnnnsssstttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy &&&& aaaa    )))) ccccoooonnnnsssstttt
  237.       Returns TRUE if this array is    different from _a, otherwise
  238.       FALSE.
  239.  
  240.       The two arrays are bitwise compared.
  241.  
  242.       See also: operator==().
  243.  
  244.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy    &&&& QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::ooooppppeeeerrrraaaattttoooorrrr====    (((( ccccoooonnnnsssstttt    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy &&&& aaaa ))))
  245.       Assigns a shallow copy of _a to this array and    returns    a
  246.       reference to this array.
  247.  
  248.       Equivalent to    assign(    a ).
  249.  
  250.      bbbboooooooollll QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::ooooppppeeeerrrraaaattttoooorrrr======== (((( ccccoooonnnnsssstttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy &&&& aaaa    )))) ccccoooonnnnsssstttt
  251.       Returns TRUE if this array is    equal to _a, otherwise FALSE.
  252.  
  253.       The two arrays are bitwise compared.
  254.  
  255.       See also: operator!=().
  256.  
  257.      cccchhhhaaaarrrr &&&& QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::ooooppppeeeerrrraaaattttoooorrrr[[[[]]]] (((( iiiinnnntttt iiiinnnnddddeeeexxxx )))) ccccoooonnnnsssstttt
  258.  
  259.  
  260.  
  261.      PPPPaaaaggggeeee 4444                         ((((pppprrrriiiinnnntttteeeedddd 9999////22222222////99998888))))
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))
  269.  
  270.  
  271.  
  272.       Returns a reference to the element at    position _i_n_d_e_x in the
  273.       array.
  274.  
  275.       This can be used to both read    and set    an element. Equivalent
  276.       to at().
  277.  
  278.       See also: at().
  279.  
  280.      vvvvooooiiiidddd QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::rrrreeeesssseeeettttRRRRaaaawwwwDDDDaaaattttaaaa (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr    **** ddddaaaattttaaaa,,,,    uuuuiiiinnnntttt ssssiiiizzzzeeee ))))
  281.       Resets raw data that was set using setRawData().
  282.  
  283.       The arguments    must be    the data and length that were passed
  284.       to setRawData(). This    is for consistency checking.
  285.  
  286.       See also: setRawData().
  287.  
  288.      bbbboooooooollll QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::rrrreeeessssiiiizzzzeeee (((( uuuuiiiinnnntttt ssssiiiizzzzeeee ))))
  289.       Resizes (expands or shrinks) the array to _s_i_z_e elements. The
  290.       array    becomes    a null array if    _s_i_z_e ==    0.
  291.  
  292.       Returns TRUE if successful, or FALSE if the memory cannot be
  293.       allocated.
  294.  
  295.       New elements will not    be initialized.
  296.  
  297.       See also: size().
  298.  
  299.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy    &&&& QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::sssseeeettttRRRRaaaawwwwDDDDaaaattttaaaa (((( ccccoooonnnnsssstttt cccchhhhaaaarrrr ****    ddddaaaattttaaaa,,,, uuuuiiiinnnntttt
  300.       ssssiiiizzzzeeee ))))
  301.       Sets raw data    and returns a reference    to the array.
  302.  
  303.       Dereferences the current array and sets the new array    data
  304.       to _d_a_t_a and the new array size to _s_i_z_e. Do not attempt to
  305.       resize or re-assign the array    data when raw data has been
  306.       set. Call resetRawData(d,len)    to reset the array.
  307.  
  308.       Setting raw data is useful because it    sets QArray data
  309.       without allocating memory or copying data.
  310.  
  311.       Example I (intended use):
  312.  
  313.           static char bindata[] = {    231, 1,    44, ...    };
  314.           QByteArray  a;
  315.           a.setRawData( bindata, sizeof(bindata) );      // a points to bindata
  316.           QDataStream s( a,    IO_ReadOnly );          // open on a's data
  317.           s    >> <something>;                  // read raw bindata
  318.           a.resetRawData( bindata, sizeof(bindata) ); // finished
  319.  
  320.       Example II (you don't    want to    do this):
  321.  
  322.           static char bindata[] = {    231, 1,    44, ...    };
  323.           QByteArray  a, b;
  324.  
  325.  
  326.  
  327.      Page 5                         (printed 9/22/98)
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))
  335.  
  336.  
  337.  
  338.           a.setRawData( bindata, sizeof(bindata) );      // a points to bindata
  339.           a.resize(    8 );                  // will crash
  340.           b    = a;                      // will crash
  341.           a[2] = 123;                  // might crash
  342.         // forget to resetRawData - will crash
  343.  
  344.       WWWWaaaarrrrnnnniiiinnnngggg:::: If you do not call resetRawData(), QArray will
  345.       attempt to deallocate    or reallocate the raw data, which
  346.       might    not be too good. Be careful.
  347.  
  348.       See also: resetRawData().
  349.  
  350.      uuuuiiiinnnntttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::ssssiiiizzzzeeee (((()))) ccccoooonnnnsssstttt
  351.       Returns the size of the array    (max number of elements).
  352.  
  353.       The array is a null array if size() == 0.
  354.  
  355.       See also: isNull() and resize().
  356.  
  357.      bbbboooooooollll QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy::::::::ttttrrrruuuunnnnccccaaaatttteeee (((( uuuuiiiinnnntttt ppppoooossss ))))
  358.       Truncates the    array at position _p_o_s.
  359.  
  360.       Returns TRUE if successful, or FALSE if the memory cannot be
  361.       allocated.
  362.  
  363.       Equivalent to    resize(_p_o_s).
  364.  
  365.       See also: resize().
  366.  
  367.      RRRREEEELLLLAAAATTTTEEEEDDDD FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  368.      QQQQ____UUUUIIIINNNNTTTT11116666 qqqqCCCChhhheeeecccckkkkssssuuuummmm    ((((ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ddddaaaattttaaaa,,,, uuuuiiiinnnntttt lllleeeennnn))))
  369.       Returns the CRC-16 checksum of _l_e_n bytes starting at _d_a_t_a.
  370.  
  371.       The checksum is independent of the byte order    (endianness).
  372.  
  373.      UUUUIIIINNNNTTTT11116666 qqqqcccchhhheeeecccckkkkssssuuuummmm ((((ccccoooonnnnsssstttt cccchhhhaaaarrrr **** ddddaaaattttaaaa,,,, uuuuiiiinnnntttt lllleeeennnn))))
  374.       Please use qChecksum;    this function is provided only for
  375.       upward compatibility.
  376.  
  377.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ooooppppeeeerrrraaaattttoooorrrr<<<<<<<< ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ssss,,,,    ccccoooonnnnsssstttt QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy &&&& aaaa))))
  378.       Writes a byte    array to a stream and returns a    reference to
  379.       the stream.
  380.  
  381.       The serialization format is the byte array size (Q_UINT32)
  382.       followed by this number of bytes.
  383.  
  384.      QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ooooppppeeeerrrraaaattttoooorrrr>>>>>>>> ((((QQQQDDDDaaaattttaaaaSSSSttttrrrreeeeaaaammmm &&&& ssss,,,,    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy &&&& aaaa))))
  385.       Reads    a byte array from a stream and returns a reference to
  386.       the stream.
  387.  
  388.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  389.       hhhhttttttttpppp::::////////wwwwwwwwwwww....ttttrrrroooollllllll....nnnnoooo////qqqqtttt////qqqqbbbbyyyytttteeeeaaaarrrrrrrraaaayyyy....hhhhttttmmmmllll
  390.  
  391.  
  392.  
  393.      Page 6                         (printed 9/22/98)
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.      QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))    TTTTrrrroooollllllll TTTTeeeecccchhhh AAAASSSS ((((9999 JJJJuuuullllyyyy 1111999999998888))))    QQQQBBBByyyytttteeeeAAAArrrrrrrraaaayyyy((((3333qqqqtttt))))
  401.  
  402.  
  403.  
  404.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  405.       Copyright 1992-1997 Troll Tech AS.  See the LICENSE file
  406.       included in the distribution for a complete license
  407.       statement.
  408.  
  409.      AAAAUUUUTTTTHHHHOOOORRRR
  410.       Generated automatically from the source code.
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.      Page 7                         (printed 9/22/98)
  460.  
  461.  
  462.  
  463.